<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!--

    Licensed to the Apache Software Foundation (ASF) under one
    or more contributor license agreements.  See the NOTICE file
    distributed with this work for additional information
    regarding copyright ownership.  The ASF licenses this file
    to you under the Apache License, Version 2.0 (the
    "License"); you may not use this file except in compliance
    with the License.  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing,
    software distributed under the License is distributed on an
    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
    KIND, either express or implied.  See the License for the
    specific language governing permissions and limitations
    under the License.

-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
<head>
<title>Add Navigation Case Dialog Box</title>
<link rel="stylesheet" href="ide.css" title="Oracle BLAFDoc" type="text/css"/>
</head>

<body>
<p><a id="org.netbeans.modules.web.jsf.dialogs.AddNavigationCaseDialog" name="org.netbeans.modules.web.jsf.dialogs.AddNavigationCaseDialog"></a></p>
<div id="NBCSH4148"><!-- infolevel="all" infotype="General" --><a id="sthref552" name="sthref552"></a>
<h1>Add Navigation Case Dialog Box</h1>
<a name="BEGIN" id="BEGIN"></a>
<p>Use to register a navigation case with the application by adding an entry to the Faces configuration file. 
<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
<param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG1153">
<param name="text" value="<html><u>How?</u></html>">
<param name="textFontSize" value="medium">
<param name="textColor" value="blue">
</object>
</p>
<p>A navigation case describes a particular condition (or set of conditions) that must be met for the navigation rule in which it is nested to be triggered. JSF's <code dir="ltr">NavigationHandler</code> handles outcomes by forwarding requests to the view defined in a navigation case's <code dir="ltr">&lt;to-view-id&gt;</code> tags.</p>
<p>JSF 2.0 applications do not require the <code dir="ltr">faces-config.xml</code> file. Navigation cases can be managed <i>implicitly</i>, meaning that navigation rules can be determined by matching outcome values with the names of pages contained in the application's web root.</p>

<table summary="User interface elements and descriptions" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0">
<col width="24%" />
<col width="*" />
<thead>
<tr align="left" valign="top">
<th align="left" valign="bottom" id="r1c1-t4">Element</th>
<th align="left" valign="bottom" id="r1c2-t4">Description</th>
</tr>
</thead>
<tbody>
<tr align="left" valign="top">
<td align="left" id="r2c1-t4" headers="r1c1-t4">
<p>From View</p>
</td>
<td align="left" headers="r2c1-t4 r1c2-t4">(<code dir="ltr">&lt;from-view-id&gt;</code>) Specifies the view identifier of the view for which the containing navigation rule is relevant. If no value is specified, the rule applies to navigation decisions for all views.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r3c1-t4" headers="r1c1-t4">
<p>From Action</p>
</td>
<td align="left" headers="r3c1-t4 r1c2-t4">(<code dir="ltr">&lt;from-action&gt;</code>) Specifies an action reference expression that must have been executed (by the default <code dir="ltr">ActionListener</code> for handling application level events) in order to select this navigation rule. If not specified, this rule will be relevant no matter which action reference was executed (or if no action reference was executed).</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r4c1-t4" headers="r1c1-t4">
<p>From Outcome</p>
</td>
<td align="left" headers="r4c1-t4 r1c2-t4">(<code dir="ltr">&lt;from-outcome&gt;</code>) Specifies an outcome string returned by the execution of an application action method selected via an <code dir="ltr">actionRef</code> property (or a literal value specified by an <code dir="ltr">action</code> property) of a <code dir="ltr">UICommand</code> component. If specified, this rule is relevant only if the outcome value matches the element's value. If not specified, the rule is relevant no matter what the outcome value was.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r5c1-t4" headers="r1c1-t4">
<p>To View</p>
</td>
<td align="left" headers="r5c1-t4 r1c2-t4">(<code dir="ltr">&lt;to-view-id&gt;</code>) Specifies the identifier of the view that should be displayed if the navigation rule is matched.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r6c1-t4" headers="r1c1-t4">
<p>Redirect</p>
</td>
<td align="left" headers="r6c1-t4 r1c2-t4">(<code dir="ltr">&lt;redirect&gt;</code>) Specifies that navigation to the view id should be accomplished by performing an HTTP redirect rather than the usual <code dir="ltr">ViewHandler</code> mechanisms.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r7c1-t4" headers="r1c1-t4">
<p>Rule Description</p>
</td>
<td align="left" headers="r7c1-t4 r1c2-t4">(<code dir="ltr">&lt;description&gt;</code>) Specifies a textual description of the element it is nested in, optionally flagged with a language code using the <code dir="ltr">xml:lang</code> attribute.</td>
</tr>
</tbody>
</table>
<br />
<!-- -->
<a id="NBCSH4155" name="NBCSH4155"></a>
<hr><p><b>Related Topics</b></p>
<p><i>Developing Applications with NetBeans IDE</i>, 
<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
<param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG1211">
<param name="text" value="<html><u>&quot;Working with the Grails Framework&quot;</u></html>">
<param name="textFontSize" value="medium">
<param name="textColor" value="blue">
</object>
</p>
<p><i>Developing Applications with NetBeans IDE</i>, 
<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
<param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG1141">
<param name="text" value="<html><u>&quot;Working with the JavaServer Faces Framework&quot;</u></html>">
<param name="textFontSize" value="medium">
<param name="textColor" value="blue">
</object>
</p>

<!-- -->
<!-- Start Footer -->


<table summary="" cellspacing="0" cellpadding="0" width="100%">
<tr>
<td align="left" width="86%"><a href="legal_notice.htm">
Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements; and to You under the Apache License, Version 2.0.</a>
</td>
</tr>
</table>
<!-- -->
</body>
</html>
